package com.ant.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsConfigurationSource;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * CORS跨域配置类
 * 
 * 解决前端和后端分离开发时的跨域问题
 * 允许来自不同域名的请求访问后端API
 * 配置允许的请求方法、请求头、Cookie等信息
 *
 * @author 灏
 */
@Configuration
public class CorsConfig implements WebMvcConfigurer {

    /**
     * 配置CORS跨域映射
     * 
     * 通过实现WebMvcConfigurer接口的addCorsMappings方法
     * 为所有路径配置跨域访问规则
     * 
     * @param registry CORS注册器
     */
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                // 允许跨域的域名，可以用*表示允许任何域名使用
                .allowedOriginPatterns("*")
                // 允许任何方法（post、get等）
                .allowedMethods("*")
                // 允许任何请求头
                .allowedHeaders("*")
                // 带上cookie信息
                .allowCredentials(true)
                // 预检请求的缓存时间（秒），即在这个时间段里，对于相同的跨域请求不会再预检了
                .maxAge(3600);
    }

    /**
     * 创建CORS配置源
     * 
     * 提供另一种配置CORS的方式，通过Bean的方式注册
     * 可以更灵活地控制CORS配置
     * 
     * @return CORS配置源
     */
    @Bean
    public CorsConfigurationSource corsConfigurationSource() {
        CorsConfiguration configuration = new CorsConfiguration();

        // 允许跨域的域名 - 支持通配符模式
        configuration.addAllowedOriginPattern("*");

        // 允许的HTTP方法 - 包括GET、POST、PUT、DELETE等
        configuration.addAllowedMethod("*");

        // 允许的请求头 - 包括自定义请求头
        configuration.addAllowedHeader("*");

        // 是否允许发送Cookie - 设置为true允许携带认证信息
        configuration.setAllowCredentials(true);

        // 预检请求的缓存时间 - 减少OPTIONS预检请求的频率
        configuration.setMaxAge(3600L);

        // 对所有路径应用这个配置
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", configuration);

        return source;
    }
}
